Zum Hauptinhalt springen
Version: 5.0

TimePunch Reporting Service

Der Reporting Service enthält Methoden zur Berichterstellung in TimePunch bereit. Die Methoden sind sehr mächtig und sollte aufgrund der Performance nur zur Auswertung eingesetzt werden.

GetDailySummaries

Diese Methode liefert eine taggenaue Zusammenfassung der Arbeitszeitdaten für den gewählten Zeitraum und die übergebenen Mitarbeiter zurück. Die Coverage Daten werden für die gesetzten Identity übernommen.

List<ReportDailySummaryDto> GetDailySummaries(  
out TpFault fault,
TpAuthentication authentication,
DateTime startDate,
DateTime endDate,
List<Guid> userIds);
Needed Permissionsummary@report
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
startDateFirst reporting date
endDateLast reporting date
userIdsList containing all user ids for which the daily summary shall be reported.
Return valueList of all daily summaries.

GetMonthlySummaries

Diese Methode liefert eine monatliche Zusammenfassung der Arbeitszeitdaten für den gewählten Zeitraum und die übergebenen Mitarbeiter zurück.

List<ReportSummaryDto> GetMonthlySummaries(  
out TpFault fault,
TpAuthentication authentication, >
DateTime startDate,
DateTime endDate,
List<Guid> userIds);
Needed Permissionsummary@report
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
startDateFirst reporting date
endDateLast reporting date
userIdsList containing all user ids for which the daily summary shall be reported.
Return valueList of all monthly summaries.

GetYearlySummaries

Diese Methode liefert eine jährliche Zusammenfassung der Arbeitszeitdaten für den gewählten Zeitraum und die übergebenen Mitarbeiter zurück.

List<ReportYearlySummaryDto> GetYearlySummaries(  
out TpFault fault,
TpAuthentication authentication,
DateTime startDate,
DateTime endDate,
List<Guid> userIds);
Needed Permissionsummary@report
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
startDateFirst reporting date
endDateLast reporting date
userIdsList containing all user ids for which the daily summary shall be reported.
Return valueList of all yearly summaries.

GetDailySummariesAnonymized

Diese Methode liefert ebenso, wie die Metode GetDailySummaries, eine tägliche Zusammenfassung der Arbeitszeitdaten der übergebenen Mitarbeiter zurück. Der Unterschied dabei ist, dass die Arbeitszeitdaten weitgehend anonymisiert werden, um nicht auf die konkreten Zeiten der Mitarbeiter schließen zu können. Daher benötigt die Methode auch eine geringere Berechtigung.

List<ReportDailySummaryDto> GetDailySummariesAnonymized(  
out TpFault fault,
TpAuthentication authentication,
DateTime startDate,
DateTime endDate,
List<Guid> userIds);
Needed Permissionsummary@reportAnon
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
startDateFirst reporting date
endDateLast reporting date
userIdsList containing all user ids for which the daily summary shall be reported.
Return valueList of all daily summaries.

GetReportTimeEntriesUserBased

Diese Methode liefert die Zeiteinträge der selektierten Mitarbeiter zurück. Der Fokus der Abfrage liegt auf den Zeiten der Mitarbeiter, nicht auf ein oder mehere Projekte.

List<ReportTimeEntryDto> GetReportTimeEntriesUserBased(  
out TpFault fault,
TpAuthentication authentication,
TimeEntrySearchDto searchDto);
Needed PermissiontimeEntries@report
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
searchDtoSearch object to filter the time entries
Return valueList of all selected time entries

GetReportTimeEntriesProjectBased

Diese Methode liefert die Zeiteinträge der selektierten Projekte zurück. Im Gegensatz zur Methode GetReportTimeEntriesUserBased stehen nicht die Mitarbeiter, sondern die Projekte im Fokus. So werden für jedes Projekt zum übergebenen Stichtag die Zeitkonten der Projekte (insgesamt, gebucht, verfügbar) ermittelt. Trotzdem selektiert die Methode auch die den Projekten zugeordneten Buchungen und gibt diese zurück.

List<ReportTimeEntryDto> GetReportTimeEntriesProjectBased(  
out TpFault fault,
TpAuthentication authentication,
out List<ReportProjectTimeDto> projectTimes,
TimeEntrySearchDto searchDto);
Needed Permissionprojects@report
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
projectTimesOutList of all project times at the given reporting date.
searchDtoSearch object to filter the time entries
Return valueList of all selected time entries

GetReportProjectTimes

Diese Methode liefert alle Projektzeiten der übergebenen Projekt-Ids, zu dem übergebenen Stichtag zurück.

List<ReportProjectTimeDto> GetReportProjectTimes(  
out TpFault fault,
TpAuthentication authentication,
ProjectSearchDto searchDto);
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
searchDtoOutSearch object to filter projects
Return valueList of all project times at the given reporting date.

GetUserAttendance

Diese Methode liefert die Anwesenheitsliste der Mitarbeiter zur Auswertung in einem Bericht.

List<ReportAttendanceDto> GetUserAttendance(  
out TpFault fault,
TpAuthentication authentication,
UserSearchDto searchDto);
Needed Permissionattendance@report
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
searchDtoSearch object to filter the time entries
Return valueList of all selected time entries

GetSalaryTimes

Diese Methode liefert die aufbereiteten Lohndaten zurück. Die Lohndaten sind auf den Monat aggregiert.

List<ReportSalaryTimeDto> GetSalaryTimes(  
out TpFault fault,
TpAuthentication authentication,
DateTime monthToExport,
UserSearchDto searchDto);
Needed PermissionsalaryExport@report
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
monthToExportDate of the monthly data to export
searchDtoSearch object to filter the time entries
return valueList of all selected time entries

GetReportUserGroups

Diese Methode liefert die Benutzergruppen zurück.

List<ReportUserGroupDto> GetReportUserGroups(  
out TpFault fault,
TpAuthentication authentication,
UserGroupSearchDto searchDto);
Needed PermissionuserGroups@access
NameModifierDescription
FaultOutContains the error if an exception occurs.
authenticationUser authentication
searchDtoSearch object to filter the user group
Return valueList of all selected user group

ExportSalaryTimes

Diese Methode liefert die aufbereiteten Lohndaten zurück. Die Lohndaten sind auf den Monat aggregiert.

Der Unterschied zur Methode „GetSalaryTimes“ ist der, dass der Datenexport in der Datenbank gespeichert wird.

Wird ein vorangeganger Monat nochmal exportiert, dann exportiert TimePunch nur die Differenz zur exportierten Hochrechnung, die aus dem damals aktuellen Monat erstellt wurde.

List<ReportSalaryTimeDto> ExportSalaryTimes(  
out TpFault fault,
TpAuthentication authentication,
DateTime monthToExport,
UserSearchDto searchDto);
Needed PermissionsalaryExport@report
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
monthToExportDate of the monthly data to export
userGroupIdId of the user group to export the salary for
return valueList of all selected time entries